home *** CD-ROM | disk | FTP | other *** search
/ Pascal Super Library / Pascal Super Library (CW International)(1997).bin / BORL_TIP / TI1000 / TI1724.ASC < prev    next >
Text File  |  1993-10-21  |  10KB  |  331 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.   PRODUCT  :  Borland Pascal                        NUMBER  :  1724
  9.   VERSION  :  7.0
  10.        OS  :  WIN
  11.      DATE  :  October 21, 1993                         PAGE  :  1/5
  12.  
  13.     TITLE  :  Making a help group for Borland Pascal
  14.  
  15.  
  16.  
  17.  
  18.   Introduction
  19.   ------------
  20.  
  21.         Borland Pascal has many text files in the \BP\DOC directory
  22.         that can be very helpful, but not quickly accessible from
  23.         within Windows.  This document will show you how you can
  24.         create a program group that contains the additional help
  25.         icons by using the GROUPS.EXE program provided with Borland
  26.         Pascal, and creating a text file to tell it where the files
  27.         are.
  28.  
  29.  
  30.   Instructions
  31.   ------------
  32.  
  33.       The steps to create the help group are the following:
  34.  
  35.       1) You need to load up an editor program with a copy of
  36.          the GROUPS.HLP text file. To do this:
  37.  
  38.          Load up an editor, the DOS command EDIT for example,
  39.          and either type in the example file below, or load this
  40.          instruction file and strip off all the text except for
  41.          the example code. DO NOT include the --TOP-OF-FILE-- and
  42.          --END-OF-FILE-- in your text file.
  43.  
  44.          Use the SAVE AS command to save the text file as:
  45.             C:\WINDOWS\GROUPS.HLP
  46.          This will make sure the file is saved under the Windows
  47.          directory.
  48.  
  49.       2) Change the directories in the example file to match the
  50.          directories on your system.
  51.  
  52.          In the included example file, the location of the Pascal
  53.          root directory is C:\BP.  If your Pascal files are in the
  54.          directory D:\BP, use a Global Search and Replace to search
  55.          for 'C:\BP' and replace it with 'D:\BP'.  This will let
  56.          the GROUPS program know where your Pascal help
  57.          and icon files are.
  58.  
  59.          If your Windows files are not located in the C:\WINDOWS
  60.          directory, you will have to do another Global Search and
  61.  
  62.  
  63.  
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70.  
  71.  
  72.  
  73.  
  74.   PRODUCT  :  Borland Pascal                        NUMBER  :  1724
  75.   VERSION  :  7.0
  76.        OS  :  WIN
  77.      DATE  :  October 21, 1993                         PAGE  :  2/5
  78.  
  79.     TITLE  :  Making a help group for Borland Pascal
  80.  
  81.  
  82.  
  83.  
  84.          Replace and replace 'C:\WINDOWS' with whatever the path
  85.          is to your Windows files, D:\WINDOWS for example.
  86.  
  87.       3) Under Windows, you will need to run the GROUPS.EXE file
  88.          along with the text file you've just edited as its
  89.          parameter.  To do this, go to the FILE menu and select
  90.          RUN.  In the field for Command Line, type
  91.  
  92.            GROUPS GROUPS.HLP
  93.  
  94.          This should run the GROUPS program, and it should ask
  95.          you if you'd like to create a Windows program group.
  96.          Click on Yes.
  97.  
  98.          If an error box pops up, you can try typing
  99.  
  100.            C:\WINDOWS\GROUPS C:\WINDOWS\GROUPS.HLP
  101.  
  102.          assuming that your Windows files are located in the
  103.          C:\WINDOWS directory.
  104.  
  105.       4) Look at the icons, they should all be yellow question
  106.          marks with titles underneath.  Also double click on some
  107.          of the icons and make sure that an editor screen comes
  108.          up with a copy of the help file in it.
  109.  
  110.       If there are problems:
  111.  
  112.          If either the icon is wrong, or the editor shows an empty
  113.          screen, the directory setting for the Pascal files is
  114.          wrong.  Make sure that the Pascal directory entry is of
  115.          the form C:\BP, or D:\BORLANDP, or something similar that
  116.          has a valid path to your Pascal directory.
  117.  
  118.          If the editor doesn't come up, there is an error with the
  119.          Windows directory path entry.  It should be something
  120.          like C:\WINDOWS.
  121.  
  122.          If the icons don't appear but the Group Box does appear,
  123.          there is a format error in the GROUPS.HLP file.
  124.          Make sure the file follows the example shown here.
  125.  
  126.          If the Group Box doesn't appear at all, GROUPS.EXE
  127.  
  128.  
  129.  
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136.  
  137.  
  138.  
  139.  
  140.   PRODUCT  :  Borland Pascal                        NUMBER  :  1724
  141.   VERSION  :  7.0
  142.        OS  :  WIN
  143.      DATE  :  October 21, 1993                         PAGE  :  3/5
  144.  
  145.     TITLE  :  Making a help group for Borland Pascal
  146.  
  147.  
  148.  
  149.  
  150.          couldn't load the text file GROUPS.HLP.  Make sure the
  151.          path to the file is valid, and that the file exists
  152.          where the path is pointing to.
  153.  
  154.  
  155.   Example File
  156.   ------------
  157.  
  158.  
  159.   IMPORTANT:
  160.       In this example file, the lines after '[icons1]' have been
  161.       split before the '='.  The actual text file must be
  162.       implemented with each help icon command on it's own line.
  163.       You must combine the lines that start with an '=' with the
  164.       line above it.  For example, you could possition the cursor
  165.       on the '=' and press BACKSPACE to bring the line up and
  166.       append it to the line above it.
  167.  
  168.       Each line should have the form:
  169.  
  170.       ExecuteFile=WorkingDir,Icon Caption,IconFile
  171.  
  172.       When this example text file is finished, it should contain
  173.       28 lines only and will create 24 help icons.
  174.  
  175.  
  176.   NOTE:
  177.       Since \BP\DOC\utils.td is too large to fit into the
  178.       NOTEBOOK.EXE editor, WRITE.EXE has been substituted.
  179.  
  180.  
  181.   FILENAME: C:\WINDOWS\GROUPS.HLP
  182.   ------------------------TOP-OF-FILE----------------------------
  183.   [group1]
  184.   caption=Borland Pascal Help Files
  185.   file=BPH7.GRP
  186.   [icons1]
  187.   WINHELP.EXE C:\BP\BIN\BPW.HLP
  188.   =C:\WINDOWS,BPW Reference,C:\BP\BIN\help.ico
  189.   WINHELP.EXE C:\BP\BIN\WORKHELP.HLP
  190.   =C:\WINDOWS,Workshop Reference,C:\BP\BIN\help.ico
  191.   WINHELP.EXE C:\BP\BIN\WINSIGHT.HLP
  192.   =C:\WINDOWS,WinSight Reference,C:\BP\BIN\help.ico
  193.  
  194.  
  195.  
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202.  
  203.  
  204.  
  205.  
  206.   PRODUCT  :  Borland Pascal                        NUMBER  :  1724
  207.   VERSION  :  7.0
  208.        OS  :  WIN
  209.      DATE  :  October 21, 1993                         PAGE  :  4/5
  210.  
  211.     TITLE  :  Making a help group for Borland Pascal
  212.  
  213.  
  214.  
  215.  
  216.   WINHELP.EXE C:\BP\BIN\WINSPCTR.HLP
  217.   =C:\WINDOWS,WinSpector Reference,C:\BP\BIN\help.ico
  218.   notepad.exe C:\BP\DOC\manual.rw
  219.   =C:\WINDOWS,Workshop Manual Update,C:\BP\BIN\help.ico
  220.   notepad.exe C:\BP\DOC\readme.rw
  221.   =C:\WINDOWS,Workshop RLE4 Notes,C:\BP\BIN\help.ico
  222.   notepad.exe C:\BP\DOC\custcntl.rw
  223.   =C:\WINDOWS,Creating Custom Controls,C:\BP\BIN\help.ico
  224.   notepad.exe C:\BP\DOC\bwccapi.rw
  225.   =C:\WINDOWS,Custom Controls Tech Notes,C:\BP\BIN\help.ico
  226.   notepad.exe C:\BP\DOC\bwccstyl.rw
  227.   =C:\WINDOWS,Custom Controls Style Notes,C:\BP\BIN\help.ico
  228.   notepad.exe C:\BP\DOC\manual.prf
  229.   =C:\WINDOWS,Profiler Manual Update,C:\BP\BIN\help.ico
  230.   notepad.exe C:\BP\DOC\helpme!.prf
  231.   =C:\WINDOWS,Profiler Reference,C:\BP\BIN\help.ico
  232.   notepad.exe C:\BP\DOC\readme.td
  233.   =C:\WINDOWS,DB/PF/ASM Release Notes,C:\BP\BIN\help.ico
  234.   notepad.exe C:\BP\DOC\manual.td
  235.   =C:\WINDOWS,Debugger Manual Update,C:\BP\BIN\help.ico
  236.   write.exe C:\BP\DOC\utils.td
  237.   =C:\WINDOWS,Debugger Utilities Reference,C:\BP\BIN\help.ico
  238.   notepad.exe C:\BP\DOC\helpme!.td
  239.   =C:\WINDOWS,Debugger Tips,C:\BP\BIN\help.ico
  240.   notepad.exe C:\BP\DOC\hdwdebug.td
  241.   =C:\WINDOWS,Hardware Interface Notes,C:\BP\BIN\help.ico
  242.   notepad.exe C:\BP\DOC\dbgboard.td
  243.   =C:\WINDOWS,Hardware Driver Notes,C:\BP\BIN\help.ico
  244.   notepad.exe C:\BP\DOC\dpmiuser.doc
  245.   =C:\WINDOWS,DPMI Reference,C:\BP\BIN\help.ico
  246.   notepad.exe C:\BP\DOC\temc.doc
  247.   =C:\WINDOWS,Turbo Macro Reference,C:\BP\BIN\help.ico
  248.   notepad.exe C:\BP\DOC\utils.doc
  249.   =C:\WINDOWS,Utilities Reference,C:\BP\BIN\help.ico
  250.   notepad.exe C:\BP\DOC\manual.tv
  251.   =C:\WINDOWS,Turbo Vision Reference,C:\BP\BIN\help.ico
  252.   notepad.exe C:\BP\DOC\helpme!.tsm
  253.   =C:\WINDOWS,Turbo Assembler Reference,C:\BP\BIN\help.ico
  254.   notepad.exe C:\BP\DOC\readme.tsm
  255.   =C:\WINDOWS,PROCDESC PROCTYPE Reference,C:\BP\BIN\help.ico
  256.   notepad.exe C:\BP\DOC\tcref.tsm
  257.   =C:\WINDOWS,TCREF Reference,C:\BP\BIN\help.ico
  258.   ------------------------------END-OF-FILE----------------------
  259.  
  260.  
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.   PRODUCT  :  Borland Pascal                        NUMBER  :  1724
  273.   VERSION  :  7.0
  274.        OS  :  WIN
  275.      DATE  :  October 21, 1993                         PAGE  :  5/5
  276.  
  277.     TITLE  :  Making a help group for Borland Pascal
  278.  
  279.  
  280.  
  281.  
  282.   Additional Information
  283.   ----------------------
  284.  
  285.   How it works:
  286.  
  287.      The GROUPS.EXE program takes a text file as input and creates
  288.      a Windows group according to the data in the file.  The text
  289.      file is of the form:
  290.  
  291.      ExecuteFile=WorkingDir,Icon Caption,IconFile
  292.  
  293.      The help files will be displayed with NOTEPAD.EXE in the
  294.      Windows directory.  You can use any Windows editor to display
  295.      the files by changing the first field from 'notepad.exe' to
  296.      whatever editor you'd like to use.
  297.  
  298.      The WinHelp help files will also be included in
  299.      the help group and are proceded by 'WINHELP.EXE'.  The help
  300.      icon is the same as the original help files, and can be
  301.      changed by naming a different .ICO file in the last field.
  302.  
  303.  
  304.      The GROUPS.EXE program is also the same one used by the
  305.      install program to create the Pascal program group.  To
  306.      recreate the original program group, execute the command
  307.  
  308.         GROUPS GROUPS.B$$
  309.  
  310.      The GROUPS.B$$ is created by the installation process, and
  311.      is located in the Windows directory.
  312.  
  313.  
  314.   DISCLAIMER: You have the right to use this technical information
  315.   subject to the terms of the No-Nonsense License Statement that
  316.   you received with the Borland product to which this information
  317.   pertains.
  318.  
  319.  
  320.  
  321.  
  322.  
  323.  
  324.  
  325.  
  326.  
  327.  
  328.  
  329.  
  330.  
  331.